home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / arce123.arc / ARCE123.DOC < prev   
Encoding:
Text File  |  1986-03-28  |  4.9 KB  |  163 lines
  1.  
  2. ARCE Command
  3. ------------
  4.  
  5. Purpose:  To extract files from an ARC archive file.
  6.  
  7. Format:   ARCE  [d:][path]filename.ext  [filespecs...] [d:outpath] [/R]
  8.  
  9. Remarks:  The drive and path names are optional. If omitted, the
  10.           current drive and path name is used.
  11.  
  12.           The filename must be supplied. The extension defaults
  13.           to ARC. All files matching the supplied filename are
  14.           processed. The ARC filename may contain the * and ?
  15.           wildcard characters.
  16.  
  17.           If no filespecs are supplied, all files are extracted.
  18.           Otherwise, only those ARC members which match one of the
  19.           up to 16 filespecs are extracted.
  20.  
  21.           The extracted files may be placed on another drive, and/or
  22.           in another subdirectory by following the optional filespecs
  23.           with a drive designator and/or path name.
  24.  
  25.           If the file being extracted already exists, you are asked
  26.           whether or not you want to over-write it. You may use the
  27.           /R option to bypass this prompt.
  28.  
  29.  
  30. Examples:
  31. --------
  32.  
  33.           o  Extract all file from TEST.ARC onto the current drive:
  34.  
  35.                 ARCE TEST
  36.  
  37.           o  Extract only file with an extension of .ASM from the
  38.              archive SOURCE.ARC on drive B and in subdirectory SAVE:
  39.  
  40.                 ARCE B:\SAVE\SOURCE *.ASM
  41.  
  42.           o  Extract all files from all ARC files in the subdirectory
  43.              called TEST on drive C:
  44.  
  45.                 ARCE C:\TEST\*
  46.  
  47.           o  Extract all files from PROGA.ARC and place the files in
  48.              subdirectory OLD on drive B:
  49.  
  50.                 ARCE PROGA.ARC B:\OLD
  51.  
  52.           o  Extract all files with an extension of .COM and .EXE from
  53.              the archive PROGS.ARC in directory NEW\WORK on drive B,
  54.              and place the them in subdirectory SAVE\TEST on drive A;
  55.              replace existing file:
  56.  
  57.                 ARCE B:\NEW\WORK\PROGS *.COM *.EXE A:\SAVE\TEST /R
  58.  
  59.  
  60. Error Messages:
  61. --------------
  62.  
  63.  'filename - premature EOF reading '
  64.   Data is missing from the archive file. The program is terminated.
  65.  
  66.  
  67.  'filename - unable to set file datestamp'
  68.   The file datestamp is set to the current date and time,
  69.   and the next archive member is processed.
  70.  
  71.  
  72.  'filename - WARNING: file CRC does not match!'
  73.   The extracted member is left on the output disk,
  74.   and the next archive member is processed. The file
  75.   is probably invalid but is left on the disk for
  76.   your examination.
  77.  
  78.  
  79.  'Invalid filespec(s)'
  80.   The filespec syntax is incorrect. The filename part may
  81.   be from 1 to eight characters, and may include the ? or *
  82.   wildcard characters. The extension may be none to three
  83.   characters, and may include wildcards.
  84.   There is a maximum of 16 filespecs allowed.
  85.   The program terminates.
  86.  
  87.  
  88.  'filename - file already exists. Overwrite it? (y/N) '
  89.   The member being extracted already exists. If you are
  90.   using a data path utility, the file may not actually be
  91.   in the subdirectory be used for output. Respond with the
  92.   letter Y to over-write the existing file, or respond with
  93.   the letter N to skip this member and continue to the next.
  94.  
  95.  
  96.  'Abort: Stack overflow'
  97.   The member being extracted has invalid data. The program
  98.   is terminated.
  99.  
  100.  
  101.  'filename - invalid decode tree count'
  102.   The member being extracted has invalid data. The program
  103.   is terminated.
  104.  
  105.  
  106.  'filename - new archive format 7 not yet supported'
  107.   Format 7 is a special file compression method used
  108.   internally by SEA, the authors of ARC. Processing
  109.   continues with the next archive member.
  110.  
  111.  
  112.  'Unable to open archive > arcname'
  113.   The specified ARC archive file was not found, or was
  114.   inaccesible. The program terminates.
  115.  
  116.  
  117.  'CREATE failed > filename'
  118.   There was insufficient directory space, or a failure
  119.   accessing the output disk. The program terminates.
  120.  
  121.  
  122.  'Invalid archive format!'
  123.   The archive file data is invalid. The program terminates.
  124.  
  125.  
  126.  'Incorrect DOS version'
  127.   Version 2.0 or later of PC DOS must be used. The program
  128.   terminates
  129.  
  130.  
  131.  'Not enough memory.'
  132.   A minimum of 112k bytes of memory is required. The program
  133.   terminates.
  134.  
  135.  
  136.  'I/O error reading from arcname'
  137.   An incorrectable error occurred attempting to read data
  138.   from the archive file. The program terminates.
  139.  
  140.  
  141.  'I/O error writing or disk full > filename'
  142.   There was not enough disk space to write the complete
  143.   archive member. The partially extracted file is scratched
  144.   and the program terminates.
  145.  
  146.  
  147.  'No matching file(s) found'
  148.   No archive files were found that matched the supplied
  149.   filename specifications. The program terminates.
  150.  
  151.  
  152. Notice:
  153. ------
  154.           By Vernon D. Buerg, Wayne Chin, and A. Kumar; for the IBM PC
  155.           using DOS 2.0 or later. All rights reserved.
  156.  
  157.                 Vernon D. Buerg
  158.                 456 Lakeshire Drive
  159.                 Daly City, CA  94015
  160.                 CompuServe: 70007,1212
  161.                 Data/RBBS:  415-994-2944
  162.  
  163.